home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr42 / audiosel.zip / AUDIOSEL.DOC < prev    next >
Text File  |  1995-03-09  |  9KB  |  222 lines
  1.  
  2.         «AudioSel» - Audio File Selection Shell v1.71α
  3.            «AudioSel/2» - Audio File Selection Shell v1.71α
  4.           «AudioSel/386» - Audio File Selection Shell v1.71α
  5.          Copyright (C) 1995 Portal System Innovations
  6.                  All rights reserved
  7.               Written by Nathan Hartwell
  8.  
  9.  
  10.                   DISCLAIMER
  11.  
  12. This program is provided "as is" without warranty of any kind, either 
  13. expressed or implied including but not limited to the implied 
  14. warranties of merchantability and/or fitness for a particular 
  15. purpose.  (Sounds familiar, doesn't it?)  There is no warranty beyond 
  16. refund of any money paid to the author by the user.  In no event 
  17. shall the author, supporting BBS systems, Sysops, or PSI software be 
  18. held liable for any damage or losses resulting from the use of this 
  19. program.  It is up to the user to determine the correct usage of this 
  20. program on his system and he/she bears full responsibility for 
  21. correct implementation of it.  
  22.  
  23.  
  24. Description:
  25.  
  26.   AudioSel was -heavily- based upon my own MODSel program.  As I get the
  27. needed information for the different audio files (ie. how to detect them), I
  28. will add them to AudioSel.  See below for a current list of file types that
  29. AudioSel recognizes.
  30.  
  31. System Requirements:
  32.  
  33.  ■ '286 or better for AudioSel.EXE running DOS v2.1+
  34.  ■ '386 or better for AudSel32.EXE running DOS v2.1+
  35.  ■ '386 or better for AudSel2.EXE running OS/2 v2.x
  36.  
  37.  
  38. Suggested Extra(s) (DOS Based):
  39.  
  40.  ■ 2+ Meg of System Memory
  41.  
  42.  
  43. Maximum Files Supported:
  44.  
  45.   AudioSel currently supports up to 4096 files.  This limit is due to memory
  46. constraints.  AudioSel/2 (OS/2) and AudioSel/386 (DOS 32-bit) support up to
  47. 10000, currently.
  48.  
  49.  
  50. Command-line Options:
  51.  
  52.  /C<str> - Specify configuration file.  Defaults to AUDIOSEL.CFG in the
  53.            directory from which AudioSel was executed.
  54.  /L<+|-> - Force the ListFile Usage On or Off
  55.       /H - An RTFM notice.  :)
  56.       /R - Force data file regeneration.  Auto-generated if the file doesn't
  57.            exists.
  58.       /U - Force file information rescan.
  59.  
  60. Configuration File Keywords:
  61.  
  62.    Keyword: Player
  63.   Required: Yes
  64.      Usage: Player [=#] (<filespec> or %<var>)
  65. Example #1: Player C:\MODPRGS\DMP.EXE
  66. Example #2: Player =15 C:\MODPRGS\S3MPLAY.EXE
  67. Example #3: Player %MODPRG
  68.       Desc: Specifies the full path and filename of the player to use.
  69.             All-in-all, 23 programs can be specified.  The optional parameter
  70.             (=#) specifies which player to use for a specific type of audio
  71.             file.  If this parameter is not used, then the player is assumed
  72.             to be the default player and is used for all file types that do
  73.             not have a program specified.  A list of file types can be found
  74.             at the end of this document.  In example #3, the environment
  75.             variable 'MODPRG' would contain the name of the executable.
  76.  
  77.    Keyword: Opts
  78.   Required: No
  79.      Usage: Opts [=#] <str>
  80.    Example: Opts /S44 /L
  81.       Desc: Specify optional command-line parameters for the audio player.
  82.             The optional argument (=#) is used in the same manner as is
  83.             mentioned in the description for 'Player'.  If no arguments are
  84.             required for a specific program, then you merely leave out the
  85.             appropriate 'Opts' entry for that player.  (i.e.  Inertia Player
  86.             doesn't accept command-line args other than the MOD file to play,
  87.             thus you would not have an 'Opts' entry coupled with the 'Player'
  88.             entry for it.)
  89.  
  90.    Keyword: Mask
  91.   Required: Yes (atleast 1, max 16)
  92.      Usage: Mask <filemask>
  93.    Example: Mask *.S3M
  94.       Desc: Specify filemask to scan.  May specify up to 16 filemasks.
  95.  
  96.    Keyword: Dir
  97.   Required: Yes (atleast 1, max 16)
  98.      Usage: Dir <path>
  99.    Example: Dir C:\MODS
  100.       Desc: Specifies the location for your audio files.  Up to 16 directories
  101.             can be specified.
  102.  
  103.    Keyword: SwapDir
  104.   Required: Yes
  105.      Usage: SwapDir (<path> or %<var>)
  106. Example #1: SwapDir C:\TEMP
  107. Example #2: SwapDir %TEMP
  108.       Desc: Specifies the temp/swap directory.  Ignored in OS/2 and 32-bit
  109.             versions.  The usefulness of the environment variable with this
  110.             keyword is very important (to me, anyway).
  111.  
  112.    Keyword: SpawnDir
  113.   Required: Yes
  114.      Usage: SpawnDir
  115.    Example: SpawnDir
  116.       Desc: Tells AudioSel to change the working directory to that of the
  117.             audio player when it executes the audio player.
  118.  
  119.    Keyword: VMode
  120.   Required: No
  121.      Usage: VMode <vidmode>
  122.    Example: VMode 0x55
  123.       Desc: Sets the display mode to that specified.  Values prefixed with
  124.             '0x' are translated as hex.  If you prefix the value with a
  125.             single '0', the value is assumed to be an octal value.  Any other
  126.             sequence is translated as decimal.  This video mode is used for
  127.             AudioSel and is reset whenever you return from a shell (including
  128.             playing a .MOD file).
  129.  
  130.    Keyword: ShellVMode
  131.   Required: No
  132.      Usage: ShellVMode <vidmode>
  133.    Example: ShellVMode 3
  134.       Desc: Sets the display mode to that specified.  Values prefixed with
  135.             '0x' are translated as hex.  If you prefix the value with a
  136.             single '0', the value is assumed to be an octal value.  Any other
  137.             sequence is translated as decimal.  This video mode is used when
  138.             shelling out for the .MOD player.  Most players won't need this.
  139.  
  140.    Keyword: DOSVMode
  141.   Required: No
  142.      Usage: DOSVMode <vidmode>
  143.    Example: DOSVMode 3
  144.       Desc: Sets the display mode to that specified.  Values prefixed with
  145.             '0x' are translated as hex.  If you prefix the value with a
  146.             single '0', the value is assumed to be an octal value.  Any other
  147.             sequence is translated as decimal.  This video mode is used when
  148.             shelling or exiting to DOS.
  149.  
  150.    Keyword: DataFile
  151.   Required: No
  152.      Usage: DataFile <filespec>
  153.    Example: DataFile C:\MODPRGS\MODLIST.DAT
  154.       Desc: Specifies the filename to use for the database.  Useful for those
  155.             using the same player with multiple configurations.  If this is
  156.             not specified, the name is generated from the configuration
  157.             filename.
  158.  
  159. Available Keystrokes in AudioSel:
  160.  
  161.        ESC - Exit AudioSel.
  162.      Space - Toggles the tag status for the audio file currently pointed to.
  163.              NOTE: Tag order is preserved.
  164.         Up - Move highlite bar up one file.  If at the top of a page, goes to
  165.              last file on previous page, except on first page.
  166.       Left - Same as 'Up'
  167.       Down - Move highlite bar down one file.  If at the bottom of a page,
  168.              goes the first file on the next page, except on last page.
  169.      Right - Same as 'Down'
  170.       PgUp - Sets highlite to first file of previous page.
  171.       PgDn - Sets highlite to first file of next page.
  172.       Home - Sets highlite to first file of current page.
  173.        End - Sets highlite to last file of current page.
  174.  Ctrl-Home - Returns highlite to page 1, file 1.
  175.   Ctrl-End - Sets highlite to last page, last file.
  176.      Alt-S - Toggles between filename and description sorting (default is
  177.              filename).
  178.      Alt-J - Jump to DOS
  179.        F10 - Jump to DOS
  180.    Alt-F10 - Jump to DOS
  181.        Del - Delete Current File (*WARNING*  No verification requested!)
  182.  Alt-Enter - Play file(s) and don't clear tag status.
  183.      Enter - Play file(s) and clear tag status.
  184.  
  185. File Types Currently Detected by AudioSel:
  186.  
  187.   0 - Generic 15 instrument MOD format
  188.   1 - Generic 31 instrument MOD format
  189.   2 - 4 Channel StarTrekker
  190.   3 - 8 Channel StarTrekker
  191.   4 - 4 Channel FastTracker
  192.   5 - 6 Channel FastTracker/TakeTracker
  193.   6 - 8 Channel FastTracker/TakeTracker
  194.   7 - 16 Channel TakeTracker
  195.   8 - 32 Channel TakeTracker
  196.   9 - Composer 669
  197.  10 - Otto Chron's AMF
  198.  11 - Farandole's Composer
  199.  12 - MED/OctaMED
  200.  13 - MultiTracker
  201.  14 - ProTracker Studio 16 (I hope)
  202.  15 - ScreamTracker v3.xx
  203.  16 - ScreamTracker v2.xx
  204.  17 - Creative Voice File
  205.  18 - Amiga Audio IFF
  206.  19 - WAVE format
  207.  20 - Creative Music File
  208.  21 - MIDI File
  209.  22 - Adlib ROL File
  210.  
  211.   Since I have no known way to specifically tell a 'NoiseTracker' file from a
  212. raw sample file, I recommend that you only point to sample files of the above
  213. 3 types.  I shall be working on a way to sort the 'NoiseTracker' files out,
  214. but I make no promises.
  215.  
  216.   If you have a mod file that is identified as NoiseTracker, but is not a 15
  217. instrument format, I would appreciate a copy so as to A) add it to my
  218. collection, and B) add it to the detection code.
  219.  
  220. If you are in FidoNet, I can be reached at 1:362/669.3
  221.  
  222.